Skip to main content

Menu Item Actions

Menu actions allow for your items to take a form of their own!

Actions​

This opens another HMCC menu. 

    actions:
      any:
        - "[MENU] main_menu" # You can add -o to the end, ex. "main_menu -o", to ignore permission of the target menu.

Close​

This closes the current menu.

    actions:
      any:
        - "[CLOSE]"

Equip​

This equips a cosmetic. Highly recommend to use the cosmetic item type, as it will account for if a player already has it equipped, unequipping said cosmetic. 

    actions:
      any:
        - "[EQUIP] explorer_backpack"

Unequip​

This unequips in a certain cosmetic slot. 

    actions:
      any:
        - "[UNEQUIP] OFF_HAND"

You can chain multiple to unequip multiple cosmetics:

    actions:
      any:
        - "[UNEQUIP] OFF_HAND"
    - "[UNEQUIP] CHESTPLATE"

Player Command​

Sends a command as the player who clicked it

    actions:
      any:
        - "[PLAYER-COMMAND] say Hi"

Console Command​

Sends a command as a console

    actions:
      any:
        - "[CONSOLE-COMMAND] say Hi"

Message​

Sends a message to the player who clicked it. 

    actions:
      any:
        - "[MESSAGE] <#d24c9f>Hello %player_name%!"

Sound​

Sends a sound to the player who clicked it. 

    actions:
      any:
        - "[SOUND] minecraft:sound.name volume pitch"

Particle​

Players a particle at the player who clicked it.

    actions:
      any:
        - "[PARTICLE] particle amount x y z" # Particles can be found https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html, xyz are offsets from the player.

Show​

Shows the cosmetics if they are hidden.

    actions:
      any:
        - "[SHOW]"

Hide​

Hides the cosmetics if they are shown.

    actions:
      any:
        - "[HIDE]"

Toggle​

Changes between hiding and showing cosmetics.

    actions:
      any:
        - "[TOGGLE]"

Examples​

Command on removal of cosmetic​

    actions:
      on-unequip:
        - "[CONSOLE-COMMAND] say A player removed a cosmetic"

Toggleable Cosmetics​

  beanie:
    slots:
      - 53
    item:
      material: PAPER
    type: empty
    actions:
      any:
        - "[TOGGLE]"